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Foreword 

This Technical Specification has been produced by the 3^^ Generation Partnership Project (3 GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

The present document is part of a TS-family covering the 3^^ Generation Partnership Project Technical Specification 
Group Services and System Aspects, Telecommunication management; as identified below: 

32.531: Telecommunication management; Software management; Concepts and Integration Reference 

Point (IRP) Requirements 

32.532: Telecommunication management; Software management Integration Reference Point (IRP); 

Information Service (IS) 

32.533: Telecommunication management; Software management Integration Reference Point (IRP); 

Common Object Request Broker Architecture (CORBA) Solution Set (SS) 

32.535 Telecommunication management; Software management Integration Reference Point (IRP) ; 

extensible Markup Language (XML) definitions 
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1 Scope 

The present document contains the Software Management Interface IRP Information Services descriptions. 

2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TR 21.905: "Vocabulary for 3GPP Specifications". 

[2] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[3] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[4] Void. 

[5] Void. 

[6] 3GPP TS 32.531: "Telecommunication management; Software management; Concepts and 

Integration Reference Point (IRP) Requirements". 

[7] 3GPP TS 32.622: "Telecommunication management; Generic network resources Integration 

Reference Point (IRP); Network Resource Model (NRM)". 

[8] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management: Information Services". 

[9] 3GPP TS 32.302: Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP); Information Service (IS). 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 32.101 [2], TS 32.102 [3] and 

TR 21.905 [1] and the following apply. A term defined in the present document takes precedence over the definition of 

the same term, if any, in TS 32.531 [6], TS 32.101 [2], TS 32.102 [3] and TS 21.905 [1], in that order. 



3.2 Abbreviations 



For the purposes of the present document, the abbreviations given in TR 21.905 [1], TS 32.531 [6] and the following 
apply. An abbreviation defined in the present document takes precedence over the definition of the same abbreviation, if 
any, in TR 21.905 [1] and TS 32.531 [6]. 
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4 

4.1 



Information Object Classes 

Imported information entities and local labels 



Label reference 


Local label 


3GPP TS 32.622 [7], information object class, Top 


top 


3GPP TS 32.312 [8], information object class, managedGenericIRP managedGenericIRP 



4.2 Class diagram 

4.2.1 Attributes and relationships 

The diagram reflects the definitions in the text of the following clauses. In case of conflict text takes precedence. 



«lnformationObjectClass» 
SwManagement IRP 



+theSWManageinentlRP 



relation-swManagementlRP-swjVl^agemeritCapabilitiei 



1 +theSWManagementlRP 
relation-swMartagementlRP-swProcess 



+theSWManagementCapabilitie&^^.^ n 

<lnfornnationObjectClass» 
SwMCapabilities 




relation-swManagementCapabilities-swManagementProfile 



+theSwManagementProfile 



+theSWManagementProfile 



«lnformationObjectClass> 
SwMProfile 
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4.2.2 Inheritance 

The diagram reflects the definitions in the text of the following clauses. In case of conflict text takes precedence. 



«lnformationObjectClass>^ 
ManagedGenericIRP 

(from TS 32.312) 



A 



«lnformationObjectClass>5- 
SwManagement IRP 



«lnformationObjectClass>:[ 
Top 

(from TS 32.622) 



A 



«lnformationObjectClass» 

GenManCapabilities 

"id 

nElnformation 

offeredFinalAdministrativeStatelnformatic^n 

stepsAndOfferedStopPointList 



A 



«lnformationObjectClass» 
SwMCapabilities 



swVersionToBelnstalledOfferList 



«lnformationObjectClass» 
GenManProfile 



id 

selectedFinalAdministrativeStat^ 

nElnformation 

stepsAndSelectedStopPointList 

versionNumber 



A 



«lnformationObjectClass>5- 
SwIVIProfile 



swVersionToBelnstalled 



«lnformationObjectClass>::f 
GenManProcess 



id 

nEldentification 
profileld 
steplnfoList 



A 



«lnformationObjectClass>::[ 
SwM Process 
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4.3 Information object class definitions 
4.3.1 GenManCapability 



4.3.1.1 



Definition 



This object class is a support object class. Sub-classes of this IOC represent the IRP Agent" s capability in support of 
automated management. 

It is created by the IRP Agent and cannot be modified by the IRPManager. 

An instance of a sub-class of genManCapability object is valid for a certain NE type or a set of NE types. 

Multiple genManCapability objects may be instantiated in the IRP Agent. 

The object identifies: 

a) the sequence of the self-configuration steps 

and for each step 

a.l) the possibility, whether before the step a stop point can be selected, such that the self-configuration step is 
suspended and waits for a request by the IRPManager to resume. 

b) the final administrativeState (ITU-T X.731) of the NE after successful self-configuration. 



4.3.1.2 



Attributes 



Attribute name 


Support Qualifier 


Read Qualifier 


Write Qualifier 


id 


M 


M 


- 


nEInformation 


M 


M 


- 


stepsAndOfferedStopPointList 


M 


M 


- 


of feredFinalAdmini St rat iveS tat e Information 


M 


M 


- 



4.3.1.3 Notifications 

None. 
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4.3.2 GenManProfile 



4.3.2.1 



Definition 



This object class is a support object class. Sub-classes of this IOC represent the IRPManager"s decision related to 
automated management. 

An instance of a sub-class of GenManProfile is valid for a certain NE type or a set of NE types. 

For an NE starting its self-configuration process (see genManProcess) there shall be no ambiguity which instance of a 

sub-class of GenManProfile is valid for a certain NE type or a set of NE types. 

Multiple instances of sub-classes of GenManProfile objects may be instantiated in the IRP Agent. 

By using an instance of a sub-class of this object the IRPManager decides which of the possible stop points offered in 
the related instance of a sub-class of genManCapability are used to suspend the automated management process of 
the specified NE type (or set of NE types) and which of the 

of f eredFinalAdministrativeStateInf ormation is selected. 



4.3.2.2 



Attributes 



Attribute name 


Support Qualifier 


Read Qualifier 


Write Qualifier 


id 


M 


M 


- 


versionNumber 


M 


M 


- 


nEInf ormation 


M 


M 


- 


stepsAndSelectedStopPointList 


M 


M 


- 


select edFinalAdminist rat iveS tat e 


M 


M 


- 



4.3.2.3 



Notifications 



None. 
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4.3.3 GenManProcess 



4.3.3.1 



Definition 



This object class is a support object class. Sub-classes of this IOC describe the automated management process for an 
NE. They allow the IRPManager to be informed about the current progress of the process and where stop points are set. 
No intervention of the IRPManager is foreseen except resume after a stop point was reached or termination of the self- 
configuration. 

When the automated management process for an NE starts, an instance of the sub-class of genManProcess is created 
automatically. 

The steps in the stepinf oList shall conform to the content of the relevant sub-class of genManProf ile instance. 
Example: 

If the stepsAndOf f eredStopPointList of a sub-class instance of genManProf ile indicates 
stopPointCanBeSetBef oreThisStep for step X, then the entry for step X in the stepinf oList of the sub- 
class instance of genManProcess can only have the value stopPointlsNotSet . 

When there is no relevant genManProf ile at creation time of genManProcess, then the IRP Agent creates the 
genManProcess based on the relevant genManCapability. In this case preferably no stop point shall be set in 
the self configuration process. 

When the last step of the self configuration process is completed successfully, the genManProcess instance is 
deleted automatically. 

When self configuration process is terminated by the IRPManager, the genManProcess instance is deleted 
automatically. 



4.3.3.2 



Attributes 



1 Attribute name 


Support Qualifier 


Read Qualifier 


Write Qualifier 


id 


M 


M 


- 


nE I den t i f i c a t i on 


M 


M 


- 


prof ileld 


M 


M 


- 


stepInfoList 


M 


M 


- 



4.3.3.3 Notifications 

None. 
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4.3.4 SwMCapability 



4.3.4.1 Definition 

This object class is a sub-class of genManCapability and represents the IRPAgent"s capability in support of SWM. 

It is created by the IRP Agent and cannot be modified by the IRPManager. 

A SwMManagementCapability object is valid for a certain NE type or a set of NE types with a certain SW version 

or set of versions. For an NE there shall be no ambiguity which SwMManagementCapability object is valid for the 

NE. 

Multiple SwMManagementCapability objects may be instantiated in the IRP Agent. 

The object identifies: 

a) the sequence of the self-configuration steps 

and for each step: 

a.l) the possibility, whether before the step a stop point can be selected, such that the self-configuration step is 
suspended and waits for a request by the IRPManager to resume. 

b) the final administrativeState of the NE after successful self -configuration. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ SWM FUN 5 




3GPP TS 32.531 [6] 


REQ ASWM FUN 1 





4.3.4.2 Attributes 

All attributes inherited from IOC GenManCapability . 
Additional attributes: 



Attribute name 


Support Qualifier 


Read Qualifier 


Write Qualifier 


swVersionToBelnstalledOfferList 


CM*) 


M 


- 



*) Condition: objectClass_is_swMCapability 

4.3.4.3 Attribute constraints 



Name 


Definition 


obj ectClass_is_swMCapability 


objectClass is equal to swMCapabilities 



4.3.4.4 



Notifications 



Name 


Qualifier 


Notes 


not ifyNewSwAvai lability 


M 
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4.3.5 SwMProfile 



4.3.5.1 



Definition 



This object class is a sub-class of genManProf ile. It allows the IRPManager to select from the stop points 
offered in the swMCapabilites object those which should be used to stop the SW management process for 
NEs, which fit to the nEInf ormation and swVersionToBelnstalled, and which of the 
of f eredFinalAdministrativeStateInf ormation is selected. 

For an NE starting its SWM process there shall be no ambiguity which swMManagementProf ile is valid 
for the NE. Therefore the nEinf ormation of different swMProf ile instances shall not intersect. Example 
for a not allowed intersection: profile 1 has nEinf ormation= (neType=eNB), profile 2 has 
nEInf ormation= ( (neType=eNB) and (Id=l)) ). 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 1 




3GPP TS 32.531 [6] 


REQ ASWM FUN 2 




3GPP TS 32.531 [6] 


REQ ASWM FUN 3 




3GPP TS 32.531 [6] 


REQ ASWM FUN 4 




3GPP TS 32.531 [6] 


REQ SWM FUN 7 


The part of the requirement to avoid 
service impact can be fulfilled by creating a 
swmProfile with 

select edFinalAdminist rat iveS tat e 
equal locked 



4.3.5.2 Attributes 

All attributes inherited from IOC GenManProf ile . 
Additional attributes: 



Attribute name 


Support Qualifier 


Read Qualifier 


Write Qualifier 


SwVersionToBelnstalled 


CM 


M 


- 



Condition: obj ectClass_is_swMProf ile 

4.3.5.3 Attribute constraints 



Name 


Definition 


obj ectClass_is_sw]y[Prof ile 


objectClass is equal to swMProf ile 



4.3.5.4 



Notifications 



Name 


Qualifier 


Notes 


notify S wMProfileCreation 


M 




notify S wMProfileChange 


CM 


Condition: Present if operation changeSwMProf ile is supported. 


notify S wMProfileDeletion 


M 
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4.3.6 SwMProcess 



4.3.6.1 



Definition 



This object class is a sub-class of genManProcess . It describes the SW management process for an NE. It 
allows the IRPManager to be informed about the current progress of the SWM process and where stop points 
are set. No intervention of the IRPManager is foreseen except to provide indication to resume after a stop 
point was reached or to abort the self-configuration. 

When the automated management process for an NE starts, an instance of the swMProcess is created 
automatically. 

The id of the swMProcess shall be identical to the identifier of the NE and identify the swMProcess 
instance uniquely. 

The steps in the stepinf oList shall conform to the content of the relevant swMProf ile instance. 
Example: 

If the stepsAndOf feredStopPointList of swMProf ile indicates 

stopPointCanBeSetBef oreThisStep for step X, then the entry for step X in the stepinf oList of 

swMProcess can only have the value stopPointisNotSet . 

When there is no relevant swMProf ile at creation time of swMProcess, then the IRP Agent creates the 
swMProcess based on the relevant swMCapability. In this case preferably no stop point shall be set in the 
self configuration process. 

When the last step of the self configuration process is completed successfully, the swMProcess instance is 
deleted automatically. 

When self configuration process is terminated by the IRPManager, the swMProcess instance is deleted 
automatically. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 




3GPP TS 32.531 [6] 


REQ ASWM FUN 3 




3GPP TS 32.531 [6] 


REQ ASWM FUN 4 




3GPP TS 32.531 [6] 


REQ ASWM FUN 5 




3GPP TS 32.531 [6] 


REQ ASWM FUN 6 





4.3.6.2 Attributes 

All attributes inherited from IOC GenManProcess . 
Additional attributes: None. 



4.3.6.3 



Notifications 



Name 


Qualifier 


Notes 


notify S wMProces sCreation 


M 




notifySwMProcessStage 


M 




notify S wMProces sDeletion 


M 
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4.3.7 SwMiRP 

4.3.7.1 Definition 

This information object represents a Software Management IRP. It inherits from IOC managedGenericIRP. 

4.3.7.2 Attributes 

All attributes inherited from IOC managedGenericIRP . 
Additional attributes: None. 

4.3.7.3 Notifications 

All notifications inherited from IOC managedGenericIRP . 
Additional notifications: None. 

4.3.8 SwMManagedEntity 
4.3.8.1 Definition 

The proxy IOC, SwMManagedEntity represents the role that can be played by an instance of a managed element. 
The objectClass and objectlnstance identify a managed element instance. 

4.4 Information relationship definitions 

4.4.1 relation-swMIRP-swMCapability (M) 

4.4.1.1 Definition 

This represents the relationship between SwMIRP and SwMCapability. 

4.4.1.2 Roles 



Name 


Definition 


theSwmIRP 


It represents the SwmIRP . 


theSwMCapability 


It represents the SwMCapability 



4.4.1.3 Constraints 

There is no constraint for this relationship. 
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4.4.2 relation-SwmlRP-swMProfile (M) 

4.4.2.1 Definition 

This represents the relationship between SwmIRP and SwMProf ile. 

4.4.2.2 Roles 



Name 


Definition 


theSwmIRP 


It represents the SwmIRP . 


theSwMProf ile 


It represents the SwMProf ile . 



4.4.2.3 Constraints 

There is no constraint for this relationship. 

4.4.3 relation-swM I RP-swM Process (M) 
4.4.3.1 Definition 

This represents the relationship between SwmIRP and SwMProcess. 



4.4.3.2 



Roles 



Name 


Definition 


theSwMIRP 


It represents the SwMIRP . 


theSwMProcess 


It represents the SwMProcess . 



4.4.3.3 Constraints 

There is no constraint for this relationship. 
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4.4.4 relation-swMCapabilites-swMProfile (M) 

4.4.4.1 Definition 

This represents the relationship between swMCapability and swMProf ile. 

4.4.4.2 Roles 



Name 


Definition 


theSwMCapability 


It represents the swMCapability . 


theSwMProf ile 


It represents the swMProf ile . 



4.4.4.3 



Constraints 



A relation can only exist between a SwMProf ile and a SwMCapability when 

a) all steps which are entries in the stepsAndSelectedStopPointList of SwMProfile have 

stopPointCanBeSetBeforeThisStep = Yes in the stepsAndOfferedStopPointList of the SwMCapability.b) 
nEInformation of SwMProfile is a subset of nEInformation of SwMCapability. 

4.4.5 relation swMProfile-swMProcess (M) 

4.4.5.1 Definition 

This represents the relationship between SwMProfile and SwMProcess. 

4.4.5.2 Roles 



Name 


Definition 


theSwMProf ile 


It represents the theSwMProf ile . 


theSwMProcess 


It represents the SwMProcess . 



4.4.5.3 



Constraints 



A SwMProcess shall perform all self-configuration steps according to StepsAndOfferedStopPointList of 
SwMProfile. 

A relation can only exist between a SwMProcess and a SwMProfile when nEIdentification of SwMProcess falls into 
nEInformation of SwMProfile. 
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4.5 



Information attribute definitions 



4.5.1 Definition and legal values 



Attribute Name 


Definition 


Legal Values 


id 


It identifies uniquely an instance of its object class. 




nEIdentif ication 


This attribute identifies the NE for which the self management activity is done. 




nEInformation 


This attribute defines the neType or NE instance/s - with optional software identification 
information - , for which this capability/profile instance is valid. 


'NE instance/s' only applies for instance/s already known to the 
IRPManager, e.g. in case of re-configuration or SW update. 


startStepName 


nameOfStep, this attribute defines the start step for resume operation. 


The legal value of startStepName could be one of the step which defined 

in StepsAndOf f eredStopPointList 


swVersionToBe Installed 


This attribute describes which SW identification information shall be used at the end of self 
management in NEs for which this swMCapability/swMProf ile applies. 




stepsAndOf f eredStopPoint 
List 


Each entry in the list contains for each step the following information: 

• nameOf Step: 

This list shall be exhaustive; if a certain step is not visible or not supported in the SWM 
process, then it shall not be shown (hsted) in the stepsAndOf f eredStopPointList. 

• sequenceNumberlnProcess 

• stopPointCanBeSetBeforeThisStep 


nameOfStep : 

swDownload, 

swinstallation, 

swActivation 

More values for nameOfStep may be used by other IRPs. 

All steps may be offered as stop points. 

sequenceNumberlnProcess : 
Positive Integer 

stopPointCanBeSetBeforeThisStep: Yes, No 


stepsAndSelectedStopPoin 
tList 


Each entry in the list contains for each step the following information: 

• nameOfStep: 

• sequenceNumberlnProcess 

• stopPointSetlndication 


nameOf SwMStep , 

sequenceNumberlnProcess : 

see StepsAndOf f eredStopPointList 

StopPointSetlndication : 
stopPointlsSetBeforeThisStep, stopPointlsNotSet 
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stepInfoList 


This list attribute contains information about all steps and how far they have progressed. Each 
entry in the list contains: 

• nameOfStep 

• sequenceNumberlnProcess 

• stopPointSetlndication 

• stepProgress 


nameOfSwMStep, 

sequenceNumberlnProcess : 

see stepsAndOf f eredStopPointList 

StopPointSetlndication : 

see stepsAndSelectedStopPointList 

StepProgress : 

notYetStarted, 

running, 

completed, 

awa i t ingRe sume , 

failure, 

terminated 


swMprocessList 


This attribute contains information about the instances of swMProcess . Each entry in the list 
contains (SET OF): 

• id 

• nEIdentif ication 

• StepInfoList 


See individual definitions of the list entry content. 


of feredFinalAdmini strati 
veState Information 


It describes which selection is offered regarding the administrativeState of the NE after 
successful automated management: If it may have the value locked or unlocked or if the value of 
the administrativeState may be determined by the configuration data which is uploaded in the 
course of the automated management. 


One or more of the following values: 

locked, 

unlocked, 

determinedByConf igurationData 

The value unlocked should always be present. 


select edFinalAdmini St rat 
iveState 


Determines which of the offers made regarding the administrativeState of the NE after successful 
self- configuration is taken. 


One of the following values: 

locked, 

unlocked, 

determinedByConf igurationData 

Default value is value unlocked. 


swVersionToBelnstalledOf 
ferList 


This list describes for which SW version/s the capability object is valid. The first element in the 
list indicates the default software version to be installed. 


Minimum size of list: 1 entry 


versionNumber 


This number is the version number of a profile. Its value is 1 when a profile is created. It is 
incremented by 1 each time a profile is successfully changed. 


Integer 


profileld 


This parameter records the identification of the profile used by the process. It consists of two 
data: 

• id (of the profile) 

• versionNumber 


See versionNumber 


matchingNEInformation 


This parameter records the information of the NE which was matching with the nEInformation of 
the profile when determining which profile is to be used for the process. 


See nEInformation 
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result 


This parameter records the result of an operation. 


success, 

failure, 

stepNameNotMatch: The current process step doesn"t match the 

startStepName in the operation. 

nEInf ormationlntersection : There shall be no ambiguity 

which swMManagementProfile is valid for the NE. Therefore the 

nEInf ormation of different swMProf ile instances shall not 

intersect. Example for a not allowed intersection: profile 1 has 

nEInformation= (neType=eNB), profile 2 has 

nEInf ormation^ ( (neType=eNB) and (ld=1)). 



4.5.2 Constraints 

None. 
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5 IRP descriptions: Interface Definitions 

5.1 Class diagram representing interfaces 



«lnterface» 
SwMOperations_1 

createSwMProfileO 

deleteSwMProfileQ 

listSwMCapabilitiesO 

listSwMProcesses() 

listSwMProfiles() 

resumeSwMProcessO 

terminateSwMProcess() 



«lnterface» 
SwM Ope rati ons_2 

changeSwMProfileO 



«lnformationObjectCI 
NotificationIRP 
(from TS 32.302) 



A 



«lnterface» 
SwM Ope rati ons_3 

downloadNESwO 
activate NESw() 



«lnterface» 
SwIVI Ope rati ons_4 

install NESwO 




«Notification» 
SwIVI Notifications_1 

notifyNewSwMCapabilitiesAvailabilityO 

notifySwMProcessCreationO 

notifySwMProcessDeletionQ 

notifySwMProcessStageO 

notifySwMProfileCreationO 

notifySwMProfileDeletionO 



«Notification» 
SwMNotifications_2 



> 



«may use» 



notifySwMProfileChangeQ 



«Notification» 
SwMNotifications_3 



notifyDownloadNESwStatusChangedO 
notifyActivateNESwStatusChangedQ 



:^:^ 



«Notification» 
SwMNotifications_4 

notifylnstallNESwStatusChangedO 



Additionally, the operations and notifications of this document are specified and grouped under Interfaces as shown in 
the following sections. To allow the flexible support of the necessary and sufficient operations and notifications for 
software management, the operations and notifications of this specification are packaged into two groups, one related to 
automatic software management (ASWM) and the other related to non-automated software management (NASWM). 

Automatic Software Management requires the following operations and notifications: 

1. SwMOperations_l and SwMNotifications_l shall be mandatory 

2. SwMOperations_2 and SwMNotifications_2 shall be optional 



Non Automatic Software Management requires the following operations and notifications: 

1. SwMOperations_3 and SwMNotifications_3 shall be mandatory 

2. SwMOperations_4 and SwMNotifications_4 shall be optional 
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«lnterface» 
SwMOperations_1 



createSwMProfileQ 

deleteSwMProfileO 

listSwMCapabilitiesO 

listSwMProcessesO 

listSwMProfiles() 

resum eSwM ProcessQ 

term inateSwM Pro cess() 



«Notification» 
SwMNotifications_1 

notifyNewSwMCapabilitiesAvailabilityO 

notifySwMProcessCreationQ 

notifySwMProcessDeletionQ 

notifySwMProcessStageO 

notifySwMProfileCreationO 

notifySwM Profile Del etionQ 



«SupportlOC» 
SwManagementIRP 



«agent-internal-usage» 



«lnformationObjectClass» 
NotificationIRP (from 32.302) 



«may realize>^ 



«may use» 



«lnterface» 
SwMOperations_2 



changeSwMProfileO 



^A 

«Notification» 
SwMNotifications_2 

not! fySwM Prof lleChangeQ 



Figure 5.1-2 Operations and Notifications for ASWM 



«lnterface» 
SwMOperations_3 

downloadNESwO 
activateNESwO 



«Notification» 
SwMNotifications_3 



notifyDownloadNESwStatusChangedQ 
notifyActivateNESwStatusChangedQ 



«SupportlOC» 
SwManagementIRP 



<agent-internal-usage» 



« Inform ationObjectCI a 
NotificationIRP (from 32.302) 



«may realize» 



«may use» 



«lnterface» 
SwMOperations_4 



nstallNESwO 



^X_ 



«Notification» 
SwMNotifications_4 



notifylnstallNESwStatusChangedO 



Figure 5.1-3 Operations and Notifications for NASWM 



5.2 Generic rules 

- Rule 1: each operation with at least one input parameter supports a pre-condition vaHd_input_parameter which 
indicates that all input parameters shall be valid with regards to their information type. Additionally, each such 
operation supports an exception operation_failed_invalid_input_parameter which is raised when pre-condition 
valid_input_parameter is false. The exception has the same entry and exit state. 

- Rule 2: each operation with at least one optional input parameter supports a set of pre-conditions 
supported_optional_input_parameter_xxx where "xxx" is the name of the optional input parameter and the pre- 
condition indicates that the operation supports the named optional input parameter. Additionally, each such 
operation supports an exception operation_failed_unsupported_optional_input_parameter_xxx which is raised 



ETSI 



3GPP TS 32.532 version 9.4.0 Release 9 



25 



ETSI TS 132 532 V9.4.0 (2011-01) 



when (a) the pre-condition supported_optional_input_parameter_xxx is false and (b) the named optional input 
parameter is carrying information. The exception has the same entry and exit state. 

- Rule 3: each operation shall support a generic exception operation_failed_internal_problem which is raised 
when an internal problem occurs and that the operation cannot be completed. The exception has the same entry 
and exit state. 

NOTE: These rules are mapped at the solution set level. Pre-conditions and exceptions, generated by these rules, 
need not appear explicitly in the present document. 



5.3 SwMIRPOperations_1 Interface (M) 

5.3.1 Operation listSwMCapabilities (M) 



5.3.1.1 



Definition 



This operation allows the IRPManager to determine on the Itf-N interface which steps in the SW management are 
performed in NEs of a certain type, what is done by the NE in case a step does not perform normally and before which 
steps a stop point can be set, such that the software download halts and waits for a continuation request by the 
IRPManager. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 1 





5.3.1.2 



Input parameters 



Parameter 
Name 


Qualifier 


Information type 


Comment 


nEInformation 


M 


swM . nEInformation 


If this input parameter contains no information, all (offered) 
SwMCapability instances are to be listed in the output. 



5.3.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


capabilityList 


M 


swM . capabilityList 


Each entry in the list contains: 

• Id of SwMCapability 

• nEInformation of SwMCapability 

• swVersionToBelnstalledOf f erList of 
SwMCapability 

• stepsAndOfferedStopPointList of SwMCapability 

• of feredFinalAdmini St rati vest ate Information 
of SwMCapability 


result 


M 


swM. result 


result = success and empty swMCapabilityList mean: No 
instance found. 



5.3.1.4 



Post-condition 



Assertion Name 


Definition 


dataDelivered 


The requested data is delivered. 
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5.3.1.5 
5.3.1.5.1 



Exceptions 
operationjailed 



Exception Name 


Definition 


operation_f ailed 


Condition: Pre-condition is false or post-condition is false. 
Returned Information: The output parameter result. 
Exit state: Entry state. 



5.3.2 Operation listSwMProf iles (M) 
5.3.2.1 Definition 

This operation allows the IRPManager to find out which instances of SwMProf ile are valid NEs of a certain type. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 1 




3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.3.2.2 



Input parameters 



Parameter 
Name 


Qualifier 


Information type 


Comment 


nEInformation 


M 


swM . nEInformation 


If this input parameter contains no information, all profile instances are to 
be listed in the output. 



5.3.2.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


swMProf ileList 


M 


swM . swMProf ileList 


Each entry in the list contains: 

• Id of profile 

• versionNumber of swMprofile 

• nEInformation of profile 

• stepsAndSelectedStopPointList of profile 

• selectedFinalAdministrativeState of 
profile 

• conditionally swVersionToBe Installed of 
swMprofile 


result 


M 


swM. result 





5.3.3 Operation createSwMProf ile (M) 
5.3.3.1 Definition 

This operation allows the IRPManager to establish an instance of SwMProf ile to be valid for NEs of a certain type. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 
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5.3.3.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


id 





swM. id 


Identifier of 
swIVIprofile 


nEInformation 


M 


swM . nEInformation 


See 4.5 


swVersionToBe Installed 


M 


swM . swVersionToBelnstalled 


See 4.5 


stepsAndSelectedStopPointList 


M 


swM . StepsAndSelectedStopPointList 


See 4.5 


select edFinalAdminist rat iveS tat e 


M 


swM . selectedFinalAdministrativeState 


See 4.5 



5.3.3.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


id 


CM 


SwMProf lie . id 


See the definition of the result field described below 


result 


M 


ENUM 
{ 

success, 

failure, 

nEInformationlnter sect ion, 

notAllowedBecauseOfOngoingSwmActivity 

} 


If result = success , then parameter id 
contains the id of the created swMProf ile . 
If result = failure , then parameter id is 
absent . 

If result = nEInf ormationlntersection, 
then parameter id contains the id of a 
swMProf ile whose nEInformation WOUld 
intersect with the proposed nEInformation for 
the new swMProf ile, which was not created in 
this case. 
If result = 

notAllowedBecauseOfOngoingSwmOperation, 
then parameter id is absent. 



5.3.4 Operation deleteSwMProf ile (M) 
5.3.4.1 Definition 

This operation allows the IRPManager to delete an instance of swMProfile. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.3.4.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


id 


M 


swM. id 


Identifier of swMprofile 



5.3.4.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


result 


M 


swM. result 
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5.3.5 Operation listSwMProcesses (M) 
5.3.5.1 Definition 

This operation allows the IRPManager to find out the status of one or several swMProcess instances 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 4 





5.3.5.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


nEIdentif ication 





swM . nEIdentif ication 


It describes for which NE the swMprocess is to be listed. 

If this parameter is not present, all swMprocess instances are to be 
listed in the output. 



5.3.5.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


swMprocessList 


M 


swM . swMprocessList 


See 4.5 


result 


M 


swM. result 


result=success and empty swMProcessList mean: No 
instance found 



5.3.6 Operation resumeSwMProcess (M) 



5.3.6.1 



Definition 



This operation allows the IRPManager to resume a SW management process which currently has stopped at a stop point 
step. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 3 





5.3.6.2 



Input parameters 



Parameter 
Name 


Qualifier 


Information type 


Comment 


id 


M 


swM. id 


Identifier of swMprocess 


startStepName 


M 


swM . NameOf Step 


The start step for the resume operation. 

If the current process step is equal to the startStepName value, the process 

will start from startStepName . 

If the current process step does not match the startStepName value, then it 

will be indicated in the result of the operation. Not matching 

StartStepName value can either be the case that the process has already 

started from the specified step (i.e. request is too late) or that the process has not 

yet reached the specified step (i.e request is too early). 
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5.3.6.3 



Output parameters 



Parameter Name Qualifier 


Matching Information Comment 


result 


M 


swM. result 





5.3.7 Operation swFallback (M) 
5.3.7.1 Definition 

This operation enables the IRPManager to initiate a SW fallback. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ SWM FUN 6 





5.3.7.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


filter 


M 


swM. filter 


To describe properties of the NEs to be selected. 



5.3.7.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching 
Information 


Comment 


nEList 


M 


swM. nEList 


Each entry in the list contains: 

nEIdentif ication 

swFallbackStatus (values : f allbackSuccessf ul , 

fallbackUnsuccessful) 


result 


M 


swM. result 


• Success, 

• Partly successful - swFallbackStatus is 
fallbackUnsuccessful for at least one NE 

and f allbackSuccessf ul for at least one Other NE 

• Failure 

Empty NEList and Result=Success means: No NEs fulfilling filter 
were found. 
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5.3.8 Operation terminateSwMProcess (M) 
5.3.8.1 Definition 

This operation allows the IRPManager to terminate a SW management process which is currently ongoing. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 6 





5.3.8.2 Input parameters 



Parameter Name Qualifier Information type 


Comment 


id 


M 


swM. id 


Identifier of swMprocess . 



5.3.8.3 Output parameters 



Parameter Name 


Qualifier 


Matching Information Comment 


result 


M 


swM. result 
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5.4 SwMIRPOperations_2 Interface (O) 

5.4.1 Operation changeSwMProf ile (O) 
5.4.1.1 Definition 

This operation allows the IRPManager to change an instance of SwMProfile. 

A change in a profile which was already used at the start of an swMProcess does not affect that swMProcess (which is 
run to its completion according to the former version of the profile. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.4.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


id 


M 


swM. id 


Identifier of 
swMprofile 


nEInformation 


M 


swM . nEInformation 


See 4.5 


swVersionToBe Installed 


M 


swM . swVersionToBelnstalled 


See 4.5 


stepsAndSelectedStopPointList 


M 


swM . StepsAndSelectedStopPointList 


See 4.5 


select edFinalAdminist rat iveS tat e 


M 


swM . selectedFinalAdministrativeState 


See 4.5 



5.4.1.3 



Output parameters 



' Parameter Name 


Qualifier 


Matching Information 


Comment 


esult 


M 


ENUM 
{ 

success, 

failure, 

nEInformationlnter sect ion, 

notAllowedBecauseOfOngoingSwmActivity 

} 


If result = success or failure , then 

parameter id may be absent or contain the id of 

the changed swMprofile . 

If result = nEInf ormationlntersection, 

then parameter conf lictingProf ileld 

contains the id of a SwIVIProfile 'A' whose 

nEInformation would intersect with the 

proposed nEInformation for the SwMProfile'B 

= input parameter id . SwMProfile'B' will not be 

changed in this case. 

If result = 

notAllowedBecauseOfOngoingSwmActivit^ 

(which means that the operation is rejected 

because another SWM activity is ongoing for at 

least one NE covered by input parameter 

ne Information), 

then parameter conf lictingProf ileld is 

absent. 


ersionNumber 


M 


SwMProfile . versionNumber 


See 4.5. This parameter has value when 
result <> success. 


onf lictingProf ileld 


C*) 


SwMProfile. id 


See definition of result above. 



Editor Note: whether this parameter needs to be conditional or mandatory needs further discussion. The condition: 

result is nEInf ormationlntersection 
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5.4.1.4 



Constraints 



Name 


Definition 


result_is_nEInformationInter sect ion 


result is equal to nEInf ormationlntersection 
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5.5 SwMIRPNotifications_1 Interface (M) 
5.5.1 Notification notifySwMProfileCreation (M) 
5.5.1.1 Definition 

This notification conveys information about the creation of an instance of IOC swMProfile. 



5.5.1.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


id 


M,Y 


swM. id 


Identifier of 
swMprofile 


versionNumber 


M, Y 


s wM . ve r s i onNumb e r 


See 4.5 


nEInformation 


M,Y 


swM . nEInformation 


See 4.5 


swVersionToBe Installed 


M,Y 


swM . swVersionToBelnstalled 


See 4.5 


stepsAndSelectedStopPointList 


M,N 


swM . StepsAndSelectedStopPointList 


See 4.5 


selectedFinalAdministrativeState 


M,N 


swM . selectedFinalAdministrativeState 


See 4.5 



5.5.2 Notification notifySwIVIProfileDeletion (M) 
5.5.2.1 Definition 

This notification conveys information about the deletion of an instance of IOC swMProfile. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.5.2.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


id 


M,Y 


swM. id 


Identifier of swMprofile 
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5.5.3 Notification notifySwMProcessCreation (M) 
5.5.3.1 Definition 

This notification conveys information about the creation of an instance of IOC swMProcess. 
Information on Requirements TraceabiHty: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.5.3.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


id 


M,Y 


swM. id 


Identifier of swMprocess 


nEIdentif ication 


M,Y 


swM. nEIdentif ication 


see 4.5 


prof ileld 


M,N 


swM. prof ileld 


see 4.5 


matchingNEInformation 


M,N 


swM. matchingNEInformation 


see 4.5 


stepInfoList 


M,N 


swM . StepInfoList 


see 4.5 



5.5.4 Notification notifySwMProcessStage (M) 



5.5.4.1 



Definition 



This notification conveys information about the stage of an instance of IOC swMProcess that has been completed or at 
which that process has been stopped (based on pre-set stop points). 

Information on Requirements TraceabiHty: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 5 





5.5.4.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment '^ 


id 


M,Y 


swM. id 


Identifier of swMprocess 


StepInfoList 


M,N 


swM . StepInfoList 


see 4.5 
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5.5.5 Notification notifySwMProcessDeletion (M) 
5.5.5.1 Definition 

This notification conveys information about the deletion of an instance of IOC swMProcess 

IRP Agent shall also send out this notification in case of a process termination caused by an exception, for example IRP 
Agent terminates the process because it had to wait too long after a suspend operation. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.5.5.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


id 


M,Y 


swM. id 


Identifier of swMprocess 


triggerForDeletion 


M, Y 


swM . triggerForDeletion 


This parameter describes what triggered the 
deletion of the swMprocess instance: 
triggerForDeletion : 

irpAgentTermination, 

irpManagerTermination, 

automatedSWMSuccesfullyConcluded 


additional Information 


0, N 


swM . additionalinf ormation 





5.5.6 Notification not ifyNewSwAvai lability (IVI) 
5.5.6.1 Definition 

This notification conveys information about the availability of new SW. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.5.6.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


nEandSWversion 


M,Y 


swM. NEandSWversion 


Informs about new available SW, SW version and NE / NE 
version (types) for which it is valid 
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5.6 SwMIRPNotifications_2 Interface (O) 

5.6.1 Notification notifySwMProf ileChange (C/0) 
5.6.1.1 Definition 

This notification conveys information about a change of an instance of IOC swMProf ile. 
Information on Requirements TraceabiHty: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.6.1.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


id 


M,Y 


swM. id 


Identifier of 
swMprofile 


versionNumber 


M,Y 


s wM . ve r s i onNumb e r 


See 4.5 


nEInformation 


M,Y 


swM . nEInformation 


See 4.5 


swVersionToBe Installed 


M,N 


swM . swVersionToBelnstalled 


See 4.5 


stepsAndSelectedStopPointList 


M,N 


swM . StepsAndSelectedStopPointList 


See 4.5 


selectedFinalAdministrativeState 


M 


swM . selectedFinalAdministrativeState 


See 4.5 



5.7 SwMIRPOperations_3 Interface (M) 
5.7.1 Operation downloadNESw (M) 



5.7.1.1 



Definition 



This operation allows IRPManager to request an IRP Agent to download network element software entities from a 
specified location. IRPManager provides a unique reference where IRP Agent can download NE software from. 

NOTE: The file transfer may not happen over Itf-N and the details on how to transfer file from IRP Agent to NE(s) is 
vendor specific and outside the scope of this specification. 

Information on Requirements TraceabiHty: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ_NASWM_FUN_1 




3GPP TS 32.531 [6] 


REQ_NASWM_FUN_2 
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5.7.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


swToBeDownloaded 


M 


List of STRUCT < 

swLocation, 

swFileSize, 

swFileCompression, 

swFileFormat 
> 


These attributes represent information about 
the NE software which will be downloaded by 
IRPAgent. 

swLocation: Denotes a unique location of 
software. This attribute includes the name of 
the software or a software version. 

swFileSize: It identifies the size of the file. Its 
value is positive Integer (the unit is byte). It is 
optional to fill in this attribute value. 

swFileCompression: It identifies the name of 
the compression algorithm used for the file. 
An empty fileCompression means that there 
is no compression on the file. Choice of 
compression algorithm is vendor-specific but 
is encouraged to use industrial standard 
algorithm such as GZIP. It is optional to fill in 
this attribute value. 

swFileFormat: It identifies the encoding 
technique used by the file. It is optional to fill 
in this attribute value 


neldentif ier 


M 


Distinguished Name (DN) 


Identifies the destination where the software 
can be downloaded and can include network 
element, managed element or managed 
functionality etc. The information is 
represented using a full Distinguished Name 
according to 3GPP TS 32.300. 



5.7.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


downloadProcessId 


M 


Integer 


An Identifier generated by IRPAgent upon receiving a 

non-automated software management request from 

IRPManager. 

In this case, it identifies the NE software download 

operation request. 


result 


M 


ENUM 

{ 

requestAccepted, 

requestFailed, 

notAllowedBecauseOfOngoingSwmActivity 

} 


Indicates whether SwMIRP has accepted or rejected 
the download request. 

It can have any one of the three possible values: 

- 'requestAccepted' which means that IRPAgent 
would perform the NE software download operation 

- 'requestFailed' which means that IRPAgent has 
failed to initiate the NE software download 
operation. Specific error condition can be captured 
in reason field 

- notAllowedBecauseOfOngoingSwmActivity 
which means that the operation is rejected because 
another SWM activity is ongoing for the requested 
NE.. 


reason 





String 


To capture detailed error reason. The field is empty 
when there is no error. 
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5.7.1.4 



Pre condition 



Assertion Name 



Definition 



swDownloadable | NE software is available which IRPAgent can download 



5.7.1.5 



Post-condition 



Assertion Name 


Definition 


swDownloadlnProgress 


The SwMIRP has accepted the download request to perform the requested 
operation. 


swAva liable 


This is the final state when downloadNESw operation is complete and 
notlfyDownloadNESwStatusChanged has been generated. 



5.7.1.6 



Exceptions 



Exception Name 


tSefmifion 


operatlonFalled 


Condition: Pre-condition is false or post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 


resourceLlmltatlon 


Condition: Operation not performed due to resource limitation. 
Returned Information: The output parameter status. 
Exit state: Entry state. 



5.7.2 Operation activateNESw (M) 



5.7.2.1 



Definition 



This operation allows IRPManager to activate network element software entity which has been previously downloaded 
or installed on the request of IRPManager. This operation may be service affecting. 

NOTE: activateNESw can be triggered through automatic or manual ways. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ_NASWM_FUN_5 





5.7.2.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


swVersionToBeActivated 


M 


swVersion 


swVersion denotes the software version which would be 
activated. The details on how to activate a software version is 
vendor specific. 


neldentif ier 


M 


Distinguished 
Name (DN) 


Identifies the destination where software has to be activated. 
This is a full Distinguished Name according to 
3GPP TS 32.300 



ETSI 



3GPP TS 32.532 version 9.4.0 Release 9 



39 



ETSI TS 132 532 V9.4.0 (2011-01) 



5.7.2.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


activateProcessId 


M 


Integer 


An Identifier is generated by IRPAgent upon receiving a 
non-automated software management request from 
IRPIVIanager. In this case, it identifies the NE software 
activation operation request. 


result 


M 


ENUM 

{ 

requestAccepted, 

requestFailed, 

notAllowedBecauseOfOngoingSwmActivity 

} 


Indicates whether SwIVIIRP has accepted or rejected 
the NE software activation request. 

It can have any one of the three possible values: 

- 'requestAccepted' which means that IRPAgent 
would perform the NE software activation operation 

- 'requestFailed' which means that IRPAgent has 
failed to initiate the NE software activation 
operation. Specific error condition can be captured 
in reason field 

- notAllowedBecauseOfOngoingSwmActivity 
which means that the operation is rejected because 
another SWM activity is ongoing for the requested 
NE.. 


reason 





String 


To capture specific error conditions. The field is empty 
when there is no error. 



5.7.2.4 Pre condition 



swAvailable or swinstalled 



Assertion Name 


Definition 


swAvailable 


The NE software has been successfully downloaded 


swinstalled 


The NE software has been installed 



5.7.2.5 Post-condition 



Assertion Name 


Definition 


swActivationlnProgress 


The SwMIRP has accepted the request to perform the requested activation operation. 


swActivated 


This is the final state when activateNESw operation is complete and 
notifyActivateNESwStatusChanged has been generated 



5.7.2.6 Exceptions 



Exception Name 


Definition 


operationFailed 


Condition: Pre-condition is false or post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 


resourceLimitation 


Condition: Operation not performed due to resource limitation. 
Returned Information: The output parameter status. 
Exit state: Entry state. 



5.8 

5.8.1 

5.8.1.1 



SwMIRPOperations_4 Interface (O) 
Operation instaiiNESw (O) 



Definition 



This operation allows IRPManager to initiate installation of NE software entity which has been previously downloaded 
on the request of IRPManager. Installation may also be initiated from a remote location. 

Information on Requirements Traceability: 
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1 Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ_NASWM_FUN_3 




3GPP TS 32.531 [6] 


REQ_NASWM_FUN_4 





5.8.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


swTobe Installed 


M 


swLocation 


swLocation denotes a unique location (local 
or remote) of software which can be a 
directory path or a URL and includes 1) the 
name of software or 2) a software version 


neldentif ier 


M 


Distinguished Name (DN) 


Identifies the destination where the NE 
software needs to be installed. This is a full 
Distinguished Name according to 
3GPP TS 32.300 



5.8.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


install Process Id 


M 


Integer 


An Identifier generated by IRPAgent upon receiving a 
non-automated software management request from 
IRPManager. In this case, it identifies the NE software 
installation operation request. 


result 


M 


ENUM 

{ 

requestAccepted, 

requestFailed, 

notAllowedBecauseOfOngoingSwmActivity 

} 


Indicates whether SwMIRP has accepted or rejected 
the installation request. 

It can have any one of the twhreeo possible values: 

- 'requestAccepted' which means that IRPAgent uld 
perform the NE software installation operation 

- 'requestFailed' which means that IRPAgent has 
failed to initiate the NE software installation 
operation. Specific error condition can be captured 
in reason field 

- notAllowedBecauseOfOngoingSwmActivity 
which means that the operation is rejected because 
automatic SWM is ongoing for the requested NE.. 


reason 





String 


To capture detailed error conditions. The field is empty 
when there is no error. 



5.8.1.4 



Pre condition 



Assertion Name 



Definition 



swAva liable 



NE software is available 



5.8.1.5 



Post-condition 



Assertion Name 


Definition 


swInstallationlnProgress 


The SwMIRP has successfully accepted the request to perform the requested 
installation operation 


swinstalled 


This is the final state when installNESw operation is complete and 
notifyinstallNESwStatusChanged has been generated 
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5.8.1.6 



Exceptions 



Exception Name 


Definition 


operationFailed 


Condition: Pre-condition is false or post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 


resourceLimitation 


Condition: Operation not performed due to resource limitation. 
Returned Information: The output parameter status. 
Exit state: Entry state. 


swNotAva liable 


Condition: NE software is not available. 

Returned Information: The output parameter status. 

Exit state: Entry state. 
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5.9 SwMIRPNotifications_3 Interface (M) 

5.9.1 Notification notifyDownloadNESwStatusChanged (M) 
5.9.1.1 Definition 

This notification, generated by IRP Agent conveys information about the status of the downloadNESw operation. 
Information on Requirements TraceabiHty: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ_NASWM_FUN_1 





5.9.1.2 



Input parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


objectClass 


M, Y 


SwMManagedEntity.objectClass 


Represents the network element 
object class generating this event. 
Also refer to Notification header [9]. 


objectlnstance 


M,Y 


SwMManagedEntity.objectlnstance 


Represents the network element 
instance generating the event. Also 
refer to Notification header [9]. 


notif icationid 


0,N 


— 


Refer to Notification header [9]. 


eventTime 


M,Y 


~ 


Refer to Notification header [9]. 


systemDN 


C,Y 


- 


Refer to Notification header [9]. 


not i f i cat ionType 


M,Y 


'notifyDownloadNESwStatusChanged' 




downloadProcessId 


M, Y 


Integer 


To allow IRPManager correlate this 
notification with the downloadNESw 
operation request. Also refer to 
section 5.7.1 


downloadOperationStatus 


M,Y 


enum { 

NE SWDOWNLOAD SUCCESSFUL, 

NE SWDOWNLOAD FAILED, 

NE SWDOWNLOAD PARTIALLY SUCCESSFUI 

} 


Provides information on the status of 

downloadNESw operation for the 

network element involved. 

Note: When only one software entity 

has to be downloaded, 

downloadOperationStatus can be 

either 

NE SWDOWNLOAD SUCCESSFUI 

or NE_SWDOWNLOAD_FAILED. 


downloadedNESwInfo 


0,N 


LIST<DownloadedNESw> 


Information on where the software 
or version got downloaded on the 
NE 


failedSwInfo 


0,N 


LIST<FailedSw, FailureReason> 


Information on software not abled to 
be downloaded and the 
corresponding failure reason. 
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5.9.1.3 



Triggering Event 



5.9.1.3.1 From State 

neSwDownloadlnProgress 



Assertion Name 


Definition 


neSwDownloadlnProgress 


IRPAgent has accepted the request to download software and downloadProcessId is 
available 



5.9.1.3.2 



To State 



neSwDownloadSuccessful or neSwDownloadFailed or neSwDownloadPartiallySuccessful , 



Assertion Name 


Definition 


neSwDownloadSuccessful 


Software has been successfully downloaded. When multiple software have to be 
downloaded, it means that all software entities have been downloaded successfully 


neSwDownloadFailed 


Software has not been downloaded. When multiple software have to be 
downloaded, it means that no software has been downloaded 


neSwDownloadPartiallySuccessful 


At least one of the software has not been downloaded (hence can be used only 
when multiple software need to be downloaded) 



5.9.1.4 



None 



Constraints 



5.9.2 Notification notifyActivateNESwStatusChanged (M) 
5.9.2.1 Definition 

This notification, generated by IRPAgent conveys information about the status of the activateNESw operation. 
Information on Requirements TraceabiHty: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ_NASWM_FUN_5 
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5.9.2.2 



Input parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


objectClass 


M, Y 


SwMManagedEntity.objectClass 


Represents the network element 
object class generating this event. 
Also refer to Notification header [9]. 


obj ectlnstance 


M, Y 


SwMManagedEntity.objectlnstance 


Represents the network element 
instance generating the event. Also 
refer to Notification header [9]. 


notif icationid 


0,N 


— 


Refer to Notification header [9]. 


eventTime 


M,Y 


- 


Refer to Notification header [9]. 


systemDN 


C,Y 


- 


Refer to Notification header [9]. 


not i f i cat ionType 


M,Y 


'notifyActivateNESwStatusChanged' 




activateProcessId 


M, Y 


Integer 


To allow IRPManager correlate this 
notification with the activateNESw 
operation request. Also Refer to 
section 5.7.2 


activateOperationStatus 


M,Y 


ENUM{ 

NE SWACTIVATION SUCCESSFUL, 

NE SWACTIVATION FAILED, 

NE SWACTIVATION PARTIALLY SUCCESSFUL 
} 


Provides information on the status o 
activateNESw operation for the 
network element involved. When the 
activation could get completed to on 
a certain extent, partial success mav 
be used. 


swVersionActivated 


CM,Y 


sw Version 


The software version which has bee 
activated. 

Condition: 

activateOperationStatus <> 
NE SWACTIVATION FAILED 


failureReason 


CM,N 


String 


The error reason when the 
activateNESw operation is not 
successful. 

Condition: 

activateOperationStatus <> 
NE SWACTIVATION SUCCESSFL 



5.9.2.3 



Triggering Event 



5.9.2.3.1 From State 

neSwActivationlnProgress 



Assertion Name 



Definition 



neSwActivationlnProgress 



IRPAgent has accepted the request to activate software and activateProcessId is available 



5.9.2.3.2 



To State 



neSwActivationSuccessful or neSwActivationFailed or 
neSwActivationPartiallySuccessful . 



Assertion Name 


Definition 


neSwActivationSuccessful 


Software has been successfully activated. 


neSwActivationFailed 


Software has not been activated. 


neSwActivationPartiallySuccessful 


When activation can be completed only to a certain extent, partial success may be 
used. 



5.9.2.4 

None. 



Constraints 
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5.10 SwMIRPNotifications_4 Interface (O) 

5.10.1 Notification notifylnstallNESwStatusChanged (O) 
5.10.1.1 Definition 

This notification, generated by IRP Agent conveys information about the status of the installNESw operation. 
Information on Requirements TraceabiHty: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ_NASWM_FUN_3 





5.10.1.2 Input parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


objectClass 


M, Y 


SwMManagedEntity.objectClass 


Represents the network 
element object class 
generating this event. 
Also refer to Notification 
header [9]. 


obj ectlnstance 


M, Y 


SwMManagedEntity.objectlnstance 


Represents the network 
element instance 
generating the event. 
Also refer to Notification 
header [9] 


notif icationid 


0,N 


— 


Refer to Notification 
header [9]. 


eventTime 


M,Y 


- 


Refer to Notification 
header [9]. 


systemDN 


C,Y 


— 


Refer to Notification 
header [9]. 


not i f i cat ionType 


M,Y 


'notifylnstallNESwStatusChanged' 




install Process Id 


M, Y 


Integer 


To allow IRPManager 
correlate this notification 
with the installNESw 
operation request. Also 
refer to section 5.8.1 


installOperationStatus 


M,Y 


ENUM{ 

NE SWINSTALLATION SUCCESSFUL, 
NE SWINSTALLATION FAILED, 
NE SWINSTALLATION PARTIALLY SUCCESSFUL 
} 


Provides information on 
the status of installNESw 
operation for the network 
element involved. 


installedNESwInfo 


0,N 


LIST<lnstalledNESw> 


Information on where the 
software or version got 
installed on the NE 


failedSwInfo 


0,N 


LIST<FailedSw, FailureReason> 


It provides information 
on the software which 
failed in installation 



5.10.1.3 Triggering Event 
5.10.1.3.1 From State 

neSwInstallationlnProgress 



Assertion Name 



Definition 



neSwInstallationlnProgress 



IRPAgent has accepted the request to install software and installProcessId is available 
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5.10.1.3.2 



To State 



neSwInstallationSuccessful or neSwInstallationFailed or 
neSwInstallationPartiallySuccessful . 



Assertion Name 


Definition 


neSwInstallationSuccessful 


Software has been successfully installed 


neSwInstallationFailed 


Software has not been installed 


neSwInstallationPartiallySuccessful 


At least one of software has not been installed 



5.10.1.4 

None. 



Constraints 
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Annex A (informative): 
Change history 



Change history 
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New 


2008-12 


SP-42 


SP-080717 






Submitted to SA#42 for information and approval 


1.0.0 


8.0.0 
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SP-44 


SP-090408 
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8.0.0 
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002 
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Add missing start step parameter for resume operation 
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003 
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SP-090290 


004 
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To add a Non-Automated Software IVIanagement operation, 
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2009-06 
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005 
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installNESw 
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9.0.0 


2009-06 
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SP-090290 


006 
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Editorial cleanup and correction of various qualifiers for TS 32.532 


8.1.0 


9.0.0 


2009-06 


SP-44 


SP-090290 


007 
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